The Original Shareware 1.1

home *** CD-ROM | disk | FTP | other *** search

/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / wptools3.zip / WPTOOLS3.DOC < prev

Wrap

Text File | 1989-03-05 | 51KB | 1,273 lines

Copyright (c) 1988, 1989 by David Seidman March 5, 1989 WPTOOLS VERSION 3.0 INTRODUCTION WPTOOLS Version 3, a shareware product, consists of a what's new file, this documentation, and thirteen programs: DISKFONT, FIXPRE, FONTFILE, FONTLIST, LISTMACS, MAKETABS, MERGESUM, PRINTIT, PRSFONTS, STYLIST, WHATPTRS, WP5LOOK, and WPSNOOP. All but PRINTIT are utilities for use with WordPerfect Version 5.0 (WP5) files only. Briefly, this is what the programs do: DISKFONT Searches a directory for specified soft font files and, optionally, lists descriptive information about the fonts it finds. FIXPRE Removes deleted (and optionally other) data packets from the prefix of WP5 document files and removes deleted data packets from WP5 setup files (WP{WP}.SET, or any other name you have used to store a setup file). For document files, this will often facilitate changing the printer driver used with the file and shrink the file. Setup files grow in size as you modify your setup; FIXPRE shrinks them again. And FIXPRE sometimes helps when WP5 just seems to be acting strangely. FONTFILE Lists the file names of the soft font files specified in a PRS file. FONTLIST List the names of the fonts used in a WP5 document. LISTMACS Lists the names and descriptions of macros in WPM and WPK files (and the keys for WPK macros), optionally sorted. MAKETABS Converts an ASCII text file to a WP5 document, replacing spaces by tabs. MERGESUM Creates a WP5 secondary merge file, each record containing the information from a WP5 document summary (or, optionally, the first 400 or so characters of a document if no summary was created), along with information from the DOS file directory. In effect, creates a database of document summaries that can be processed using the WP5 Merge and Sort functions. PRINTIT Paginates and formats an ASCII text file for printing. PRSFONTS Lists and optionally numbers the names of the fonts available in a WP5 PRS file. STYLIST Lists names and descriptions of styles, optionally sorted. WHATPTRS Lists the printers described in ALL files, optionally sorted by printer name. WP5LOOK Displays one or more WP5 document files specified on the command line. Particularly because files can be specified with wildcards, WP5LOOK may be more convenient than WP5 itself for browsing through WP5 documents. WPSNOOP Determines, in greater or lesser detail, the file type of many, but not all, files associated with recent WordPerfect Corporation products. For document files, lists the document summary. For macro files, lists the description. Optionally reveals the structure of WP5 document file prefixes and of WP5 setup file prefixes. More detail on each program is given below, along with a description of WP5 document file prefixes. WPCorp has no connection with these programs, except that it provided the technical information necessary to write some of them. .............................................. Notes on Input and Output You normally supply these programs with one or more input file names ("Infile") and sometimes an output file name ("Ofile") on the DOS command line. The file name may always include drive and path specifications. The individual program descriptions mention where wildcards (* and ?) can be used. Many of these programs are intended to read WP5 files. Wildcards may cause the program to try to read incorrect file types. Generally, these programs ignore input files of the wrong kind. Many of these programs by default write their output to "standard output," but output will go to a WP5 file instead if you specify an output file (usually with a -o switch). Sending the output to standard output can be useful. By default, standard output means the screen --the output goes to the screen in a continuous flow. This may not be what you want, either because more than one screen's worth of output will be generated or because you want to keep or otherwise use the output. Instead of letting standard output go directly to the screen, you can pipe it to another program, or redirect it to either the printer or a file. For example, screen display is more useful if you pipe output to the DOS filter MORE: WPSNOOP *.* |MORE or, better, to Vernon Buerg's LIST: WPSNOOP *.* |LIST /s You might also pipe to PRINTIT and redirect the output from PRINTIT to the printer directly or to a file for later printing: WPSNOOP *.* |PRINTIT >prn or WPSNOOP *.*|PRINTIT >outfile Or you can have the program output go directly to an ASCII text file: WPSNOOP *.*>outfile .............................................. I. DISKFONT DISKFONT has two uses: 1. To provide information about a soft fonts by reading the soft font disk file. 2. To examine a list of fonts to determine whether their files are on the disk. DISKFONT reads a list of soft font file names and searches for the files in a specified disk directory. By default, it lists information about the fonts in the soft font files it finds. Optionally, it merely reports the names of the font files it fails to find. FONTFILE (another WPTOOLS program) creates a list of soft font file names referenced in a PRS file. This list may be used as input to DISKFONT, which can process the list to find whether the files are available or to provide more information about them. Note that the ALL file from which a PRS file was made may reference more soft fonts than the PRS file references. Soft fonts are referenced in a PRS file only if you chose to include them in the PRS file, using * or + (or both). Therefore, the list generated by FONTFILE may be smaller than the list WPerf is capable of displaying. Usage: DISKFONT [-Option] [-Option] Input is a list of filenames from standard input. The filenames may include standard DOS wildcards. FONTFILE output is acceptable input to DISKFONT, and may be piped to it. If the input is a file containing a list of soft font file names, use input redirection (<infile). Input may also come from the keyboard; in that case, use ^Z followed by Enter to terminate keyboard input. Output goes to standard output by default and may be piped or redirected. Options: -Ddirectory (Directory where fonts are) If no directory is supplied, default directory is assumed. If the input filenames include directory information, that overrides the command line. -OOFile For WP5 output. Formatting of the WP5 file assumes, but does not set, left and right margins of 1" and a 10-pitch monospaced font; the tabs set by DISKFONT may seem strange if those are not your defaults. -F Only find fonts--no info given -? Help message Limitation: DISKFONT has been tested only with font files compatible with an HP LaserJet Series II. Examples: DISKFONT Keyboard input, output to standard output (screen). DISKFONT <myfonts.txt Input, myfonts.txt, is an ASCII text file containing a list of font file names. Output to screen. FONTFILE My.PRS|DISKFONT -Dc:\wp\fonts|PRINTIT>prn Input is list of font files referenced by My.PRS. The list is created by FONTFILE and piped to DISKFONT. The font files are in subdirectory \wp\fonts on drive C:. DISKFONT output is piped to PRINTIT. PRINTIT output is redirected to the printer. Here is an example of the output from DISKFONT: * * * * Report for font file AC0060RH.HPF: FontName Swiss Typeface 4 (Helvetica) Orientation Portrait Height 6.0 points Style Upright Font Weight 2 Font type 8-bit Symbol Set HP Roman-8 Spacing Proportional. Space width is 1.68 points * * * * FontName is the name stored in the font file as the name of the font, although some fonts are usually referred to by a different name. Typeface is a number (0-255). For some typefaces, DISKFONT can supply the typeface name. Orientation is Portrait or Landscape. Height is a standard measure of the height of the font. It is not necessarily the height of any character in the font. Style is either Upright or what HP calls "italic." HP notes that other values may be assigned -- DISKFONT will not recognize them. Weight is the stroke weight of the font, a value from -7 to +7. According to HP, 0 means "medium," 3 means "bold," and -3 means "light." DISKFONT translates the numbers to words according to HP's scheme. Not everyone uses that scheme. BITSTREAM, for example, apparently treats 2 as meaning bold. Font Type comes in three varieties. "7-bit" indicates that ASCII codes 32-127 are printable. "8-bit" indicates that ASCII codes 32-127 and 160-255 are printable. "PC-8" indicates that all ASCII codes except 0,7-15, and 27 are printable. Symbol Set indicates which characters will actually print. This is stored by number in the file. It is possible DISKFONT will not translate some numbers to words. Spacing is proportional or fixed. For either, an appropriate measure of the spacing is listed. DISKFONT was inspired by Gary Elfring's program FONTINFO. II. FIXPRE A. WP5 Document Files WP5 document files have two sections: the document prefix (created by WP5), which contains document default settings, fonts, styles, and similar information; and the document itself (text and codes entered by the user). More information about prefixes appears in a separate section below. FIXPRE strips certain information out of the prefix of a WP5 file; much of the information stripped concerns printers and fonts, while most of the rest is obsolete. When you read the stripped file created by FIXPRE back into WP5, WP5 restores the printer and font information. This sounds pretty pointless. Why do it? There are several reasons: (1) Some users have had difficulty printing files after changing printer drivers or when the files were created on another system. Use FIXPRE to clean the printer-related information out of the prefix; then read the file into WP5 and install with new drivers. The difficulties may disappear. (The UPDATE function introduced in the WP5 July 1988 maintenance release solves many printer driver problems of this kind, but apparently not all.) (2) As you edit a file, WP5 adds new information to the prefix and marks old information as no longer valid. In early releases of Version 5.0, this led to some problems. Although these problems may have disappeared with the November 15, 1989 release, some aspects may remain. This description is based on earlier releases of WP5. The FASTSAVE option in the WP5 configuration setup (which is not the default setting with which the program is shipped) speeds disk saves of documents because it does not delete from the prefix the old, invalid information. Therefore, files edited in FASTSAVE mode tend to be larger than other WP5 files, sometimes startlingly so. If you SLOWSAVE a file, most (but not all) of the outdated information is physically deleted from the prefix, but not if you FASTSAVE. FIXPRE physically deletes the information marked as deleted (and, depending on how you configure FIXPRE, other information as well--the valid printer and font information, as noted above). So you could either use SLOWSAVE regularly, or you could use FASTSAVE -- and FIXPRE from time to time. (3) Another reason for using FIXPRE is harder to describe. Sometimes the formatting in a WP5 file goes haywire. The problem may -- or may not -- go away if you FIXPRE the document. For example, this document was originally written in WP5, using Courier 10. I changed to Courier 12, didn't like the results, and went back to Courier 10. After those changes, centered lines were no longer centered properly, and many of the tabbed and indented lines were also off. After trying a few ways of fixing the problem, I FIXPREd the document and read it back into WP5. Problem gone. I can't explain why the document went bad, or why FIXPRE fixed it. But if you run into strange formatting problems, give FIXPRE a try. Other problems to which this solution may apply include misplaced graphic lines and improper font printing. B. WP5 Setup Files The WP5 setup file, WP{WP}.SET, also contains a number of data packets. As you change your setup (without making a new setup file), new data packets are added and old ones marked as deleted. WP5 seems never actually to remove these deleted data packets from the setup file. FIXPRE will remove them. I have seen setup files shrink to 1/10th their size. WordPerfect Corporation advises erasing the set file and starting again. FIXPRE is easier. C. Using FIXPRE Usage: FIXPRE Infile [Ofile] [-Option] [-Option] Infile is the WP5 document or setup file to be fixed. Ofile is not required. If it is provided, Infile will be unchanged, and the fixed file written to Ofile. If you do not provide an Ofile name, Infile will be renamed (as a backup), and the fixed file will be written under the original Infile name. The backup file name is based on the Infile name. It is the main part of the Infile name, with a new extension. The backup file will NOT overwrite any existing file. Suppose the Infile you supply is LETTER.DOC. The program tries to use the name LETTER.F01 for the backup. If a file with that name exists, the program tries LETTER.F02, and so on through F99 (where the program gives up and asks you to provide an output file name). When the program is finished, LETTER.DOC will be the fixed file. Options: (separate multiple options by blanks) -K Kill (do not preserve) the backup file. The .Fxx file will be deleted when the program finishes. The remaining options are ignored if the input file is a setup file. Options F and H have no effect if option D is used. -F By default, FIXPRE replaces Infile's "document flags." -F preserves the original document flags. It is not clear this is ever useful. -H By default, FIXPRE eliminates the prefix's "formatter hash table." -H preserves it. It may never be sensible to use this option. -D With this option, FIXPRE strips only deleted data packets from the prefix. If all you want to do is shrink a file, this option may save a bit of time. III. FONTFILE FONTFILE extracts the list of names of soft font files found in a PRS file. These files must be present on disk and accessible to WP5 in order to print documents which use the fonts they contain. FONTFILE can be used in conjunction with DISKFONT to determine whether those files are present on disk. Usage: FONTFILE Infile [Ofile] Infile should be a PRS file. The file extension defaults to PRS. Output goes to standard output, unless Ofile is supplied. Output can, and often should, be piped to DISKFONT. See example above. You might also want to redirect the output to an ASCII text file and then use the text file as input to DISKFONT when you are preparing to print a document that uses the PRS file. If Ofile is supplied, the output is in WP5 format. Limitation: FONTFILE has been tested only with HP LaserJet Series II printer files. IV. FONTLIST FONTLIST displays a list of the names of the fonts used in a WP5 document file. (This list is found in the document's prefix, which FONTLIST reads.) This list may be useful if you are not sure whether the fonts used in a document are available on your disk. FONTLIST output can be misleading in two ways. First, the initial font, or any font specified in a document's initial codes setting, will appear on the list even if you did not use the font. (FIXPRE in default mode will delete initial fonts.) Second, fonts which were once used in a document but later replaced or removed will also appear in the list. To avoid listing these fonts, you can use FIXPRE on the document, read the document into WP5, and then save it. FONTLIST should then produce a list of fonts actually used in the document (plus the initial font). Often, font names in the list will be preceded by an extraneous character. You should be able to tell by observation that it is extraneous. Usage: FONTLIST Infile [Ofile] Infile is a WP5 document file. Output is written to standard output unless Ofile is provided. If Ofile is provided, output is in WP5 format. V. LISTMACS LISTMACS produces a list of up to 1000 macros in its input files; both WPM and WPK files contain macros (each key redefinition in a WPK file is a macro). The output includes the file name, macro description, and, for WPK macros, the name of the key to which the macro is assigned. By default, the output is sorted by filename and, within filename, by macro description. Alternate sorts, or no sort, may be selected as options. Usage: LISTMACS infile .. [infile] [-oOfile] [-sortoption] Up to 5 Infiles, which may include wildcards. Output to standard output unless Ofile specified with -o. If Ofile specified, output is in WP5 format. WP5 tab settings assume 1" left margin and 10 pitch monospaced font. Sort options (default is sort by filename): -N No sort -D Sort on macro Description -K Sort on Key name Example: LISTMACS c:\wp\*.wpk c:\wp\*.wpm -D lists macros in all wpm,wpk files, sorted by description VI. MAKETABS MAKETABS converts ASCII text files to WP5 documents, replacing sequences of spaces by tabs. MAKETABS replaces spaces with tabs by either of two methods and, in one method, according to either default tab settings or those the user supplies. The output WP5 file begins with a tab set code if the user supplied a tabstring or tab spacing information to the program. This form of conversion is particularly useful for lists and tables, including the output of some other WPTOOLS programs. Usage: MAKETABS -OOfile [-Option] [-Option] -O : output file. Required. Options: -IInfile Input filename. If there is no -I option, MAKETABS defaults to standard input, and input may be piped or redirected, or it may come from the keyboard. -Tn1;n2;..;nmTabstring (in columns of the ASCII input) -Sn Tab spacing (for equally spaced tabs). In columns. Default is 5. -M Use Method 2 (tabs not based on tabstring or tab spacing) -Nn MiNimum spaces to replace. Default is 3 -Xn MaX spaces to replace (Method 2). Default is 80. -Ln WP5 Left margin (inches and tenths). Default 1.0. Method 1, the default method, replaces spaces by tabs to match particular tab specifications. Thus a sequence of spaces ending at the column to which a tab would move the cursor (given the particular tab specification) is replaced by a tab, but a sequence of tabs of the same length that fits between two tab positions is not replaced by tabs. To use Method 1, MAKETABS requires a tab specification. The tab specification it uses is always given in terms of column positions. By default, it uses tabs set at 5 column intervals (5;10;15;20, etc. -- the limit for a tab specification is column 255). Thus if a line starts with four spaces, they will be replaced by a tab. If it starts with five spaces, the result will be a tab followed by a space. If it starts with a letter followed by three spaces, the spaces will be replaced by a tab. If it starts with two letters followed by two spaces, by default the spaces will not be replaced by a tab (because of the default minimum spaces value of 3 -- you can change that with the -N option). You can change the tab specification in two ways. Using the -S option, you can change the interval from the default value of 5. Alternatively, you can use the -T option to specify a tab string completely. That option allows you to set tabs properly to reflect the pattern of spacing in the file you are converting. For example, to line up the columns of LISTMACS ASCII output with tabs rather than spaces, use -T9;15;61 (you would also use -N0, because there are likely to be some very short sequences of spaces). If you do specify tab settings in either of these ways, the appropriate tab set command is included at the beginning of the WP5 output file. Column positions are assumed to represent tenths of an inch. However, the WP5 tab settings are not a direct translation into inches of your column specification. MAKETABS assumes that the ASCII text file begins at the beginning of a line, but that WP5 files have a left margin. By default, MAKETABS assumes a WP5 left margin of 1.0". So the WP5 tab settings resulting from the -T command in the previous paragraph are 1.9", 2.5", and 7.1". You can change the assumed left margin with the -L command (e.g., -L1.5). MAKETABS does not put a margin change command in the output file. Method 2 ignores tab settings entirely. It simply replaces any sequence of spaces of at least the minimum length (up to the maximum--see the -X option above) by a single tab. For an example, see below under WHATPTRS. VII. MERGESUM MERGESUM extracts document summaries from WP5 files and writes them, along with information from the DOS file directory, to a WP5 secondary merge file. The result is a database of document summaries. You can then use the WP5 Merge and Sort functions to manipulate the output. The secondary merge file MERGESUM creates has the following fields: 1: File path 2: File name (without extension) 3: File extension 4: Creation date (as it appears in the summary) 5: Creation date (yy/mm/dd, for easier sorting) 6: File date (yy/mm/dd) from DOS directory 7: File size (bytes, 7 column field, right justified) 8: Descriptive Filename 9: Subject/Account 10: Author 11: Typist 12: Comments If, for example, you wanted a report listing, in three columns, the full file name, the creation date in yy/mm/dd form, and the Descriptive Filename, you would use a primary merge file like this: ^F1^^F2^.^F3^[Tab]^F5^[Tab]^F8^ (After the merge output file is created, replace hard page breaks by hard returns. Or use ^N^P^P at the end of the primary merge file to avoid hard page breaks.) By default, the secondary merge file includes no mention of any WP5 document files included in the input file specifications that do not have document summaries. However, the filename, file date, and file size for these files are available. You can also choose to write this information to standard output. You can also choose to include records for these files in the secondary merge file, using just the DOS file directory information or also including the first roughly 400 characters of the document text as the "comments." Usage: MERGESUM Infile [Infile] -oOfile [-A] [-C] [-S] Any number of Infiles, which may include wildcards. -oOfile the secondary merge output file Options: -A include All WP5 files in Ofile, even if they have no document summary. -C like -A, but includes the beginning of the document text as Comments. -S information on files with no summaries written to Standard output. Note: You can use -S along with -A or -C. VIII. PRINTIT PRINTIT has nothing to do with WP5 and, despite its name, does no printing. It formats ASCII text files for printing. Many of the programs in WPTOOLS write output to standard output by default. This output is unpaginated and has no left margin. Sending it directly to your printer will produce less than ideal results. PRINTIT reads standard input, paginates it, puts a heading on each page (the heading has the date and a page number, and optionally includes a title), and writes it to standard output. It does not insert any printer control codes in the output file - - pages are filled with blank lines where necessary. By default, it provides no left margin, assumes the page length is 66 lines, and puts 60 lines of text on the page. You can specify a left margin on the command line, and you can clone the program to change the default left margin, the page length, and the last printing line. The default page length and bottom line are probably suitable for most printers. For printers such as the HP LaserJet, you will want to clone the program to change the number of lines of text on a page. PRINTIT does NOT write anything to the printer. It writes to standard output. You can redirect its output to the printer, or you can redirect its output to a file and copy the file to the printer. Usage: PRINTIT ["title"] [-Option] Input from standard input Output to standard output Title appears on each page of the output. Enclose the title in double (") or single ( ', but NOT ` ) if it contains blanks. If the title includes one kind of quotation mark, use the other to enclose it. Options: -? Help -n n is a digit,0-9, the number of columns to offset the output from the left edge. -C Clone for page length, bottom line, offset (number of blank columns to insert before the text). Cloning is fully prompted -- simply follow the directions. Cloning overwrites the executable file with a modified version (and so the program file may have a later date than you would expect). If you use DOS 2.x, you must have PRINTIT.EXE in the default directory. If you use DOS 3.x, PRINTIT will find itself under whatever name you use for it. If you use DOS 4.x, let me know what happens. PRINTIT is based on code in Software Tools in Pascal, by Kernighan and Plauger. The cloning routine is David Doty's WritExec, which is based on David Dubois' AutoInst. Because of the origins of the program, it is not subject to the limitations of the WPTOOLS license provisions. Anyone may use PRINTIT without paying the WPTOOLS license fee. IX. PRSFONTS PRSFONTS lists the fonts available in a WP5 PRS file. This is useful if you have a laser printer and create numerous PRS files. PRSFONTS can number the list, starting with zero. These numbers are the basis for the ID numbers you must supply to an HP LaserJet Series II printer if you download soft fonts from the DOS command line, rather than relying on WP5 to download them. Whether these numbers are suitable for other printers has not been tested. Usage: PRSFONTS Infile [Ofile] [-N] Infile is a WP5 PRS file. If no extension is supplied, extension PRS is assumed. Output is written to standard output unless Ofile is specified. If it is specified, output is in WP5 format. -N Number the fonts. X. STYLIST STYLIST produces a list of up to 1000 styles in document files and style libraries. The list includes the filename, the name of the style, the letter P (for paired) or the letter O (for open) to indicate the type of style, and the style description. By default, the output is sorted by filename and within filename by style name. Other sorting options are available. Usage: STYLIST Infile [Infile] [-oOfile] [-sortoption] Up to 5 Infiles may include drive, directory, wildcards. Output to standard output, unless Ofile is specified (with -o). If Ofile specified, output is in WP5 format. WP5 formatting sets left and right margins to 0.5". Tab settings based on assumption of 10 pitch monospaced font. Sort options (default is sort by filename): -N No sort -D Sort on style Description -M Sort on style naMe -T Sort on style Type (Paired, Open) Example: STYLIST c:\wp\*.sty c:\wp\*.doc -D lists styles in all sty and doc files, sorted by description XI. WHATPTRS A single ALL file can be used to create PRS files for a number of different printers. WHATPTRS lists the printers for which the input ALL file can create drivers. Each line of the output begins with the name of the input ALL file, followed by the name of a printer. The program can usually sort by printer name. Whether WHATPTRS can sort all the printer names depends on how many printers there are in the input ALL files and on the amount of memory available. If you cannot sort the full collection with WHATPTRS itself, you could pipe unsorted output to the DOS SORT routine. The WHATPTRS sort is not sensitive to case; because the DOS sort is sensitive to case, the -L option is available to put printer names into all lower case. Some printer names in ALL files begin with *, to indicate that the source of the printer information in the file is not WordPerfect Corporation. To permit a proper sort, WHATPTRS moves the * from the beginning to the end of the printer name. Usage: WHATPTRS Infile[.ext] [Ofile] [-option] [-option] Infile may include wildcards. ext defaults to ALL. Output to standard output unless Ofile is specified. If Ofile is specified, output is in WP5 format. -S Sort output by printer name. -L output Lower case printer names. Examples WHATPTRS *|PRINTIT>prn Prints a list of printers in all the ALL files in the default directory. WHATPTRS * -L|Sort/+15|MAKETABS -OutFile -M Produces (in OutFile) an alphabetically sorted list of printers in all the ALL files in the default directory, in the form of a WP5 file formatted with tabs rather than spaces. You can get the same results with WHATPTRS * OutFile -S -L WHATPTRS * -L|find "panasonic" >prn Prints the names of all Panasonic printers in the ALL files in the default directory, together with the name of the ALL file applicable to each printer. XII. WP5LOOK WP5LOOK is a file browsing program for WP5 document files. It displays WP5 document files listed on the command line. (The document summary is displayed if it exists.) The program pauses as each screen is displayed. If there is more information in the document, you can page forward. Generally, you can also page backward within a document, although only for a few screens (the number varies, but is never more than eight). At each screen, you also have the options of going back to the beginning of the file (Home), jumping to the end of the file, going on to the next file, or quitting the program. (If there are no more files, the next file and quit options produce the same results.) You can also search for strings in the displayed file. The top line of the display indicates the corresponding WordPerfect page numbers. WP5LOOK does not correctly format files, but its display will typically be a reasonable approximation of the proper formatting. The program is designed for use when you need to rummage through one or more WP5 documents quickly (or when not enough memory is available to use WP5 itself), not for when you care about the details of formatting. Here are some of the formatting problems: -- Paragraphs are reformatted by default to a 75-character line, although you can change the number from 75; the right margin is especially ragged, because words are not split at hyphens. Margin changes are ignored. Line spacing is ignored. Multiple columns are placed end to end. -- Everything is displayed in the same font. -- Tab settings are ignored. Ordinary tabs are displayed as five spaces, more exotic tabs as a single space. Indent codes are all treated as ordinary, not left- right. An indent code is represented as five spaces. Indented text is indented five spaces. -- Centering is based on an 80-character line. -- Characters a standard IBM PC cannot display and overstruck characters are displayed as upsidedown question marks. -- Footnotes and endnotes are displayed embedded in the text where they occur. They are set off by line breaks and enclosed between **FN: and **EFN. -- Styles, initial codes, graphics, captions, and so forth are ignored. Usage: WP5LOOK Infile [Infile] .. [Infile] Infile may include wildcards. You may specify as many Infiles as fit on the command line. Once you have started the program, operation is prompted and for the most part intuitive. The bottom line on the screen indicates which keystroke options may be chosen (except for W, which is never indicated). In some cases, you can use different keystrokes to achieve the same result. The prompt does not indicate that flexibility. Here is the full set of options, only some of which may be available at particular screens: Move one screen forward PgD, [space], [return] To last screen in file [End] Move one screen back PgU, b, B To first screen in file [Home] To next file N Exit from the program Q, [esc], F7 Search (exact match) S Find (match ignoring case) F Set line Width, 10-80 chars. W Search and Find When you select Search or Find, you are prompted for a search string. Search looks for an exact match to your search string. Find looks for a match but ignores differences in case. (Searching for cat will not match CAT, but Finding cat will match CAT.) If you have previously done a Search or Find in the same WP5LOOK session, you will be shown your previous search string. If you want to use the same search string, simply hit <enter>. You can also edit the search string. If the first keystroke you hit is a character rather than an editing key, the previous search string will disappear, and you simply enter (and edit) a new one. Searching and Finding search from the currently displayed screen to the end of the file. The first screen containing a match is displayed, with each line containing the match highlighted. After each match, you are asked whether you want to continue looking for the same string. To search the entire file, you must start the search at the beginning of the file (which you can reach with the Home key). Leading and trailing blanks in the search string can be used if you want to limit searches to matching whole words. For this purpose, screen display lines of your WP5 document file are treated as beginning and ending with blanks. The search string may include blanks, so you can search for phrases (limited to 60 characters). However, matches are limited to a single line -- if a phrase is split between lines in the display, you cannot match it. The search string can be edited using the cursor keys and other keys in an intuitively obvious manner. WordStar editing commands are also available. A complete list of editing commands follows (commas indicate alternatives): <Enter> (<Return>) Accept line <Esc> Quit without changing line; do not search <Left>,<CtrlS> Cursor left one character <Right>,<CtrlD> Cursor right one character <CtrlLeft>,<CtrlA> Cursor left one word <CtrlRight>,<CtrlF> Cursor right one word <Home>,<CtrlQ><S> Cursor to line beginning <End>,<CtrlQ><D> Cursor to line end <Del>,<CtrlG> Delete character at cursor <Bksp>,<CtrlH>, Delete character to left of cursor <CtrlBksp> <CtrlEnd>,<CtrlQ><Y> Delete to end of line] <CtrlY>, <CtrlX> Delete entire line <CtrlHome> Delete from beginning of line <CtrlT> Delete word to right of cursor <Ins> Toggle insert mode on or off. Size of cursor indicates the mode. Default is insert mode off. <CtrlR>,<CtrlQ><L> Restore original contents of line after editing XIII. WPSNOOP WPSNOOP displays information concerning its input file(s). If WPSNOOP recognizes an input file as a WPCorp-type file, it at least identifies the WPCorp product to which the file is related. If the file is recognized as a WordPerfect file (and it is not for versions earlier than 5.0), WPSNOOP reports on the type of file. If the file is a WP5 document file, WPSNOOP lists the document summary if one exists. If the file is a WP5 macro file, WPSNOOP lists the macro description. Used with a wildcard input file specification, WPSNOOP can therefore provide useful identification for many of the files. For WP5 document files and setup files, WPSNOOP optionally provides considerably more information, although most WP5 users will not find this information useful. For a WP5 document file, WPSNOOP can display information about the file prefix -- in particular what sort of data packets are contained within the prefix, where they are located and how large they are. (Data packets are part of the organizational structure of the file prefix; the term data packet comes directly from WPCorp.) Similar information can be shown for a setup file. Usage: WPSNOOP infile [infile] [-oOfile [-V] Up to 5 infiles, which may include wildcards. Output is written to standard output, unless Ofile is specified (with -o). If Ofile is specified, output is in WP5 format. -V option for Verbose report, which includes full map of data packets. Limitations: With the Verbose option, WPSNOOP may not provide information about a few indexes which technically exist but provide no information. The end of useful information is signalled (generally) by an index identifying a data packet of the "end of prefix" type. All data packets after the first such data packet are identical (or at least provide no useful information). WPSNOOP reports on only the first of these, even though others may exist. If the index pointing to the "end of prefix" data packet has an index number less than 4, enough additional identical indexes exist so that the last of them is No. 4. GENERAL INFORMATION ABOUT WP5 FILE PREFIXES This section provides some basic information about WP5 file prefixes. Although this information may help you understand the situations in which FIXPRE is likely to be useful, you do not need to read this section in order to use FIXPRE, and the less technically inclined might wish to skip it. A WP5 file document file has two areas: the prefix area and the document area. The document area contains, roughly speaking, the keystrokes you put into the file; it corresponds to the entire file in earlier versions of WordPerfect, which did not use prefixes. The prefix area begins with a "file prefix," which identifies the file as a WP5 file, indicates where the document area begins (as an offset in the file), and does little more. The rest of the prefix area consists of "data packets" (which contain a wide variety of information about printers, defaults, fonts, graphics, styles, and other matters) and indexes (which identify where in the prefix particular data packets are located). The indexes are organized in blocks. Each block consists of a "header index" and four other indexes. The header index identifies itself as such, provides some information which is the same for every WP5 document file header index and is therefore not interesting, and gives the offset in the file where the next index block begins. Each of the other four indexes in a block identifies the type of data packet to which it is an index, the length of that data packet in bytes, and the offset in the file where the data packet can be found. WP5 document files can have the following kinds of data packets, as well as some that published information has apparently not yet identified: Document summary Document default values Document flags Font name string pool Graphic image data Formatter hash table List of fonts used in document Document printer information Style PS tables for fonts In addition, there may be deleted packets. The structure of a WP5 setup file is identical to that of a WP5 document file prefix, except that it has a different set of data packets. UPDATE NOTES WPTOOLS Version 3 differs from Version 2 in a number of respects. (1) Two new programs, MERGESUM and WP5LOOK, have been added. (2) PRSFONTS has been modified to limit its output to the actual fonts where possible and to allow numbering of the fonts. The 50,000 character limit on the list of fonts has been reduced by 3,000. (3) FONTLIST has been modified so that it will work correctly with some files that it did not properly handle before. (4) WHATPTRS now can itself sort the printer list; it also moves the position of an asterisk WPCorp added to some printer names. One of the two formats for output has been deleted. (5) A number of the programs, which previously sent output only to standard output, now optionally write WP5 format output. (6) FIXPRE has been modified to allow more convenient operation. Progress comes at a price. The registration fee for WPTOOLS3 is $5 greater than for WPTOOLS2. David Seidman Software by Seidman 2737 Devonshire Pl. NW Washington, DC 20008 CompuServe: [70441,2414] * * * * * * * * * * * * * * * LICENSE INFORMATION WPTOOLS3 is not in the public domain. Both the collection and the individual programs are fully protected by copyright. You are granted without charge a license which permits (a) use of the programs for a period of 30 days for evaluation and testing; (b) making copies for distribution to others without charge, provided the programs and the accompanying documentation are distributed together and without modification; (c) posting the programs, together with the accompanying documentation, on electronic bulletin board systems. (For PRINTIT only, you are granted without charge a license to use the program for as long as you like.) Use after the 30 day evaluation and testing period requires payment of a license fee. For a single copy (plus necessary archival copies), to be used on only one computer at a time, the fee is $25.00. For your convenience, an invoice form is included below. For large quantities, discounts and site licenses are available. Write for information. Any license for which payment is properly made is valid for this version of WPTOOLS and all subsequent versions. What do you get for your license fee? Aside from permission to use the programs and the warm feeling that you are not violating the copyright laws, not very much, but a little. If you pay the license fee to me and tell me the version you have (or if I can figure out what version you have), I will send you the next version (unless the next version involves a trivial change too small to worry you about). After that, I will send you notification of further new versions. And if you let me know about any problems you have with the programs, I will try to solve them. Users groups and other not-for-profit organizations may distribute unmodified copies of WPTOOLS3, together with its accompanying documentation, for a fee to cover duplication and related costs, but not to exceed $6.00. Your payment of such a fee does not eliminate the requirements concerning payment of a license fee. Certain organizations may have been granted permission to distribute the program for a fee larger than $6.00, the larger fee to include the license fee for a single copy. If the organization from which you received a copy of the program has been granted that permission, it should tell you so. The United States Department of Justice is granted a license, without payment of fee, for all official use of WPTOOLS3. WARRANTY INFORMATION These programs are distributed without warranties of any kind, express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. No representation or other affirmation of fact, including but not limited to statements regarding suitability for use, or performance of the programs, shall be or be deemed a warranty by the licensor for any purpose, nor give rise to any liability or obligation of the licensor whatever. In particular, no statement in program documentation shall be deemed a representation or warranty that the programs will perform in any particular manner, or perform in any manner whatsoever, or that the programs are suitable for any particular use or any use at all. * * * * * * * * * * * * * * * INVOICE David Seidman Software by Seidman 2737 Devonshire Pl. NW Washington, DC 20008 DATE: SOLD TO: __________________________ __________________________ _________________________ ┌──────────────────────────────────────┬────────────────────────┐ │ Description │ Price │ │ │ │ ├──────────────────────────────────────┼────────────────────────┤ │ │ │ │ License for WPTOOLS3.1 │ $ 25.00 │ │ │ │ │ additional licenses @ $25.00 │ _____.__ │ │ │ │ │ │ │ │ │ │ │ │ │ └──────────────────────────────────────┴────────────────────────┘ Total: $_____.__ D.C. Residents add 6% D.C. Sales Tax: ___.__ Total Charge: $_____.__ Make checks payable to David Seidman. Please mark checks "WPTOOLS31". ------------------------------------------------------------